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1.0 SCOPE 


This document describes the external features and 
characteristics of CYBIL-CC Interactive Debug, a supervisor 
program running under the NOS operating system. It is primarily 
directed toward programmers who are assumed to be familiar with 
CYBIL-CC and NOS. 

1.1 APPLICABLE DOCUMENTS 


Publication Number 


NOS Reference Manual Volume 1 
NOS Reference Manual Volume 2 
Network Products Interactive 
Version 1 Reference Manual 
Network Products Interactive 
Users Guide 

CYBER Interactive Debug 

Version 1 Reference Manual 
CYBIL Language Specification 
CYBIL Handbook 



60445400 

60445300 

Facility 

60455250 

Facility 

60455260 


60481400 

60457280 

60457290 
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2.0 INTRODUCTION 


CYBIL-CC Interactive Debug (CCDBG) extends the capabilities of 
CYBER Interactive Debug (CID) to allow symbolic debugging of 
CYBIL-CC programs. Locations within a CYBIL-CC program can be 
referenced by variable names and line numbers if the program was 
compiled with the DEBUG option selected. This option causes 

CYBIL-CC to produce special tables for CCDBG as part of the 

object code. 

The CID command syntax has been completely changed in CCDBG. 
Many changes have been made to the parameters of most commands to 
handle CYBIL-CC modules, procedures and stacks instead of Fortran 
structures. The overall capabilities of CCDBG, however, differ 

little from those of CID. There are only four new 

commands: FORWARD, BACKWARD, DISPLAY_DE FAUL T S and 

CHANGE_DEFAULTS. The COMPASS or machine level capability of CID 
has been maintained, and the overall design of CID has not been 
changed. 

2.1 OVERVIEW 


CCDBG is a supervisory program loaded in the user field length 
to operate on loaded object programs. No special source 
statements are needed in the program to be debugged; however, a 
special compiler option must be selected if symbolic debugging is 
desired. In addition to its symbolic referencing capabilities, 
CCDBG controls program execution as determined by user-defined 
breakpoints and traps, allows the user to look at and change 
memory and registers, and defines a sequence of CCDBG commands 
and gives them a procedure name so that they will execute each 
time the name is referenced or on occurrence of a specified 
breakpoint or trap. Breakpoint, trap and procedure definitions 
may be saved on a file for use in future sessions, and the 
session may be checkpointed to be restarted later. 

2.2 TERMINOLOGY 

Breakpoint A location within a program where the program's 

execution may be interrupted by a monitor routine. 

Default The name of the CYBIL-CC module that was executing 

Module when CCDBG gained control, unless a subsequent 

CHANGE_DEFAULTS command specified a new module name 
as the default module. At initial start-up of 
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CCDBG, the default module is the module at which 
program execution is to begin. Default module is 
equivalent to HOME PROGRAM in CID. 

The CYBIL-CC procedure that was executing when 
CCDBG gained control, unless a subsequent 
CHANGE_DEFAULTS command specified a new procedure 
name as the default proc. At initial start-up of 
CCDBG, the default proc is undefined. 

Entry Point A special named location within a program which may 
be accessed by programs compiled separately. If 
there is an alias, the alias name will be used. 
Entry points are limited to 7 characters by the 
CYBER Loader, if they are longer than 7 characters, 
only the first 7 characters will be used. To 
reference an entrypoint that contains a character 
that is not legal in a name, the entrypoint name 
must be enclosed in single quotes. 

Expression An algorithm used for computing a value. A CCDBG 

expression may contain symbolic address references, 
CCDBG variables, numeric literals, and the 
operators + and -. They may be used to express an 
address or a value. 

Heap A dynamic storage area explicitly allocated and 

freed by CYBIL-CC programs. 

Interactive Capable of a two-way back and forth exchange of 
information. 

Interpret Execution of computer machine instructions by other 

than direct means. A special routine examines each 
instruction and simulates its execution. 

Map A list of module and entry point memory addresses, 

produced when the program is loaded. 

Module A compilation unit in CYBIL-CC. This is the alias 

defined in CYBIL-CC or the first 7 characters of 
the module name if there is no alias. To reference 
a module which contains a character that is not 
legal in a name, the module name must be enclosed 
in single quotes. 

Nested A procedure that is defined within another 

procedure. 


Default 

Proc 
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Overlay 


Procedure 


Program 

Separator 


Stack 


Trace 


A portion of a program which can share an area of 
memory with other similar program portions. When 
access to a particular portion of the program is 
required, the overlay containing that portion is 
loaded, overlaying the previous contents of the 
memory area. 

A named portion of a program in CYBIL-CC. This is 
the actual name defined in CYBIL-CC, not an alias. 

The completely loaded set of one or more modules. 

A character required between two items so that they 
may be distinguished. In CCDBG, spaces or commas 
are used as separators between parameters and 
between elements in a list, and semi-colons and 
end-of-line are used as separators between 
commands. 

A dynamic storage area automatically allocated by 
CYBIL-CC programs on each procedure call. 

An ordered list of procedures or modules that have 
executed, showing program flow. 


2.3 METALANGUAGE 


Throughout this document, whenever a CCDBG command is 
discussed, the manner of writing that command is illustrated with 
a uniform system of notation. This notation is called a 
metalanguage and is not part of CCDBG. Through the use of a 
metalanguage we are able to provide a brief, but precise, 
explanation of the general patterns that CCDBG permits. The 
metalanguage does not describe the meaning of the language 

elements, merely their structure; i.e., it indicates the order in 

which the elements may (or must) appear, punctuation that is 

required, and options that are allowed. These following 
metalanguage rules apply: 

1) The symbol :: = is read as "IS DEFINED TO BE". 

2) Elements enclosed by < > are to be considered a single 

syntactic unit in relation to surrounding meta symbols. 

3) Elements enclosed by [ ] are optional and are to be 

considered a single syntactic unit in relation to surrounding 
meta symbols. 
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4) Elements separated by | are mutually exclusive, and the 
symbol is read as "OR". 

5) Elements followed by ... can be repeated. 

6) <..> will be used to indicate that an ellipsis (two or more 
periods) is required. In this case, the ellipsis is part of 
the language. 

7) <ascii> will be used to indicate that an ascii character is 
required. 

8) <sp> will be used to indicate that a space is required. 

9) The symbol EOL will be used to indicate end of line. 

2.4 BASIC CONCEPTS 

2.4.1 INTEGER 


<integer> = <dec_digit> [<digit>...] [(<base>)] 

Integers may be expressed as octal (8), decimal (10), or 
hexadecimal (16). When the base specification is omitted, 
decimal (10) is assumed. When a hexadecimal representation is 
specified, a leading zero may be required to ensure that the 
constant begins with a decimal digit. 

2.4.2 NAME 


<name> ::= <alpha> [<alpha>|<digit>] ... 

A name is a string of alphanumeric characters not contained in 
a comment or constant. The name must be preceded and followed by 
a delimiter. Any character not allowed inside a name delimits a 
name. The initial character of a name must not be a digit and 
the number of characters in a name must not exceed 31. 

2.4.3 ADDRESS 


<address> ::= <expr> 

An address is an expression which when evaluated, provides an 
18 bit central memory address or a 24 bit ECS address. 
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2.4.4 CCDBG VARIABLES 

These variables are part of CCDBG and are available to the 
user. They all have identifiers beginning with #. Ten user 
variables designated #V1, #V2,...,#V10 may be changed by the 
user. The other variables may be accessed by the user, but may 
not be changed. 

#BP Number of breakpoints currently defined. 

#TP Number of traps currently defined. 

#PR Number of debugger SCL procedures currently 

defined. 

#FL Central memory field length. 

#P Program address register. 

#ERRCODE Reprieve error code. 

#CPUERR Mode error code. 
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The following CCDBG variables may only be accessed when CCDBG 
is in interpret mode. 

#INS Current instruction as number. 

#INSL Current instruction length (15, 30 or 60) 

#PARCEL Instruction parcel counter. 

#OP OP code of current instruction. 

i field of current instruction. 

#J j field of current instruction. 

#K k or K field of current instruction. 

#EA Effective address of current instruction. 


#EW 

#PC 

#PA 


Effective word. 
Previous contents. 


Previous address. 
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<expr> [<operator>] <operand> [<operatorxoperand>] . . . 

<operator> ::= <+>|<-> 

<operand> ::= <constant>|<name>|(<expr>) 

An expression is an algorithm for computing a value. 

2.4.6 SEPARATOR 
<sep> ::= <sp>|<,> 

A comma or a space may be used to separate parameters or 
elements in a list. 

2.4.7 COMMENTS 


<comment> ::= "<ascii> [<ascii>]..." 

Comments are not interpreted by CCDBG and serve only as 
documentation. A comment acts syntactically the same as a space; 
i.e., whenever a space is allowed a comment is allowed, and 
whenever a space is required as a delimiter a comment will serve 
the same purpose. 

2.4.8 COMMAND 


<command> ::= ccommand name> [<sepxparam list>] 

A command consists of the command name followed by any 
parameters necessary to control its operation. 

2.4.9 PARAMETER LISTS 


<param list> : := <param> [<sepxparam>] . . . 

A parameter list consists of a series of parameters separated 
by spaces or commas. Each parameter in the list can be specified 
in one of three formats. The first format consists simply of the 
parameter name. 

<param name> 

The second format consists of the name followed by parameter 
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text. 

<param namex = | <sp>> <param value> 

Both of the above formats are positionally independent; i.e., 
the order in which they are quoted is unimportant. The third 
format is positionally dependent and consists simply of parameter 
text. The positional significance of a parameter is one greater 
than the previous parameter specified in the list. Omission of a 
parameter can be indicated by two consecutive commas. 

<param value> 

2.4.10 VALUE LISTS 


cvalue list> ::= (<value> [<sepxvalue>] . . .) 

A value list consists of a series of values separated by 
spaces or commas and enclosed in parentheses. 

2.4.11 CONTINUATION 


cinput line> ctextx . . ><EOLxtext> 

Commands can be continued by placing an ellipsis at the end of 
the line. The first character of the continuation line replaces 
the first character of the ellipsis. The total number of 
characters must not exceed 150. The maximum length of a line of 
lower case letters (ASCII 6/12 format) is 120. 
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3.0 GENERAL DESCRIPTION OF CCDBG USE 


A CCDBG session must begin with a DEBUG(ON) control statement 
that places the operating system in CCDBG mode. It remains in 
CCDBG mode until the control statement DEBUG(OFF) is entered. 
When the operating system is in CCDBG mode, the CCDBG supervisory 
module is loaded as part of the system response to a request for 
the load of an object program. Subsequent execution begins 
within the CCDBG module, not the user program, and the following 
message appears at the terminal: 

CYBIL-CC INTERACTIVE DEBUG 


The question mark is a prompting character issued by CCDBG 
each time it is waiting for a response from the terminal. 

Once the CCDBG header line appears, the user should enter the 
CCDBG commands that would set breakpoints and traps, specify 
output options, or preset any data values. A command of EXECUTE 
or GO starts execution of the object program. 

When any of the specified conditions occur, the condition is 
reported, the execution is suspended, and control passes to the 
user at the terminal. Diagnostics and trap and breakpoint 
reports are displayed with a preceding asterisk. 

During the time the user has control, CCDBG commands can be 
entered to display program locations, change location values, set 
additional breakpoints and traps, and generally explore the 
behavior of the program. If necessary, the HELP command can be 
executed to learn about CCDBG commands. 

Program execution resumes at the location where it was 
suspended, or at a user specified location. Any abnormal program 
abort, as well as normal program termination, returns control to 
CCDBG. 

Debugging of a particular program ends when the QUIT command 
is entered. This command terminates CCDBG control, and other 
terminal operations can be performed. If any user program is 
subsequently referenced in a load request, however, CCDBG is 
again loaded and gains control. 

CCDBG features are listed below, along with general 
information about them. 


60460320 01 





3-2 

12/13/83 
REV: 1 


3.0 GENERAL DESCRIPTION OF CCDBG USE 

3.1 PROGRAM EXECUTION CONTROL 


CDC - SOFTWARE ENGINEERING SERVICES 
ERS for CYBIL-CC Interactive Debugger 


3.1 PROGRAM EXECUTION CONTROL 


Program execution halts whenever a user-defined breakpoint or 
trap condition occurs. Execution can be resumed at the point at 
which it was interrupted or at any other specified program 
location within the same procedure. 

An interrupt command provides a general stop-on-demand 
capability that can terminate infinite loops or excessive output. 

3.2 CYBIL-CC SOURCE SYMBOL REFERENCE CAPABILITY 


Locations within a CYBIL-CC module can be referenced by 
variable names and line numbers if the module was compiled with 
the DEBUG option selected. Fields of records may be referenced 
using the same notation used in CYBIL-CC (including pointer 
notation). Array elements may be referenced using a subscript 
only if the subscript is a constant of the same type as the array 
index. Variables and names used as constants are not allowed as 
subscripts. 

3.3 MACHINE LEVEL DEBUGGING FEATURES 


Several features relating to the hardware instruction set and 
program registers are available. 

Program register values can be examined and changed. 

Step mode execution by trapping each instruction prior to 
execution. 

Instruction-oriented trap definitions cause execution in 
interpret mode. Each time execution stops, the i, j and k 
operands, and the effective address of the current 
instruction can be displayed. 

After a write or read, the value can be displayed, and the 
value previously written or the prior contents of the X 
register before a read can be displayed. The previous 
contents of the A register can also be displayed. 

3.4 OVERLAY ENVIRONMENT 


Program execution can be trapped when particular overlays are 
loaded. Details of the overlay structure and of the loaded 
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overlays can be indicated. An overlay qualifier can be used in 
specifying an address or module name. 

3.5 DEBUGGER SCL PROCEDURE 


A debugger SCL procedure consists of a sequence of CCDBG 
commands and can be given a procedure name, such that all 
commands in the sequence execute each time the procedure name is 
referenced. 

Similarly, a breakpoint or a trap can be defined with a CCDBG 
SCL procedure that executes each time the specified event occurs. 

3.6 CONDITIONAL COMMAND EXECUTION CAPABILITY 


A SKIPIF command within a debugger SCL procedure allows some 
CCDBG commands to execute only when particular program values or 
status variables exist. 

3.7 VETO MODE 


Veto mode gives the user veto power over each individual 
command within a debugger SCL procedure that is otherwise 
executing automatically. 

3.8 DEFINITION FILE CAPABILITY 


Definitions of traps, breakpoints, and debugger SCL procedures 
can be saved on a file. This feature eliminates the need to 
re-enter long CCDBG sequences in future sessions. 

3.9 CHECKPOINT/RESTART CAPABILITY 


A CCDBG session can be checkpointed. The session may later be 
restarted with the CCDBG environment intact. 

3.10 WARNING CAPABILITY 


A warning message is displayed prior to the execution of a 
command that would destroy existing definitions, or that might 
produce uncertain results. 
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3.11 CCDBG VARIABLES 


Special identifiers can reference CCDBG variables containing 
information such as current program address, field length, number 
of breakpoints, traps or debugger SCL procedures defined. Ten 
scratchpad variables can be fully controlled by the user. 

3.12 INFORMATION OUTPUT 


Listings that can be obtained during a CCDBG session include: 

Load map information 

Current CCDBG environment 

Currently defined CCDBG SCL procedures 

At any time during the CCDBG session, the user can direct a 
log of the remainder of the session to be written to a file for 
later printing. 

3.13 HELP COMMAND 


The 

obtain 


HELP command can be used any time during a session to 
a summary of information about CCDBG features. 
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4.0 CCDBG COMMANDS 


The following sections describe the features of CCDBG 
commands. The description of the parameters denotes the 
positional order of the command parameters. 

4.1 BREAKPOINTS AND TRAPS 


Breakpoints and traps provide a means for monitoring program 
execution. When a breakpoint location is reached, execution of 
the program is suspended, and CCDBG gains control. For a trap, 
CCDBG gains control when some specific condition occurs. In 
either case CCDBG commands may be processed, allowing a 
programmer to look at and change elements of the executing 
program. 

Both traps and breakpoints may be established with "bodies". 
A body is a sequence of CCDBG commands that are executed 
automatically when the trap or breakpoint occurs. In this case, 
the user does not receive notification of the breakpoint or trap, 
nor does the user receive control unless a PAUSE command is 
executed as part of the body of the breakpoint or trap. 

The fact that a trap or breakpoint is being established with a 
body is indicated by the presence of the collect parameter on a 
SET_BREAKPOINT or SET_TRAP command. All subsequent commands, 
until a collect_end is encountered, constitute the body. These 
commands are checked for syntax errors when they are entered, but 
they are not executed until the breakpoint or trap condition 
occurs. 

4.1.1 SET_BREAKPOINT | SB 


This command sets a breakpoint in the user's program at a 
specified location. It may also start the definition of a body 
(set of CCDBG commands between collect and collect_end). 

set_breakpoint [address_expr] 

[module=<name>][overlay=(<integer> 

,<integer>)] [offset=<integer>] 

[first=<integer>] [last=<integer>] 

[step=<integer>] [ccollectxeol | ; > 
[<command_statementxeol | ; >] ... 
ccollect end>] 
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address_expr: The address specified by this parameter is known as 
the base address and may be specified in any of the 
following ways: 

line | l=<integer> 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

entrypoint | e=<name> 

Where name is an entry point identifier. 

NOTE: automatic variables and parameters are not 

available until the procedure prolog is completed. 
This form is included primarily for use with COMPASS 
entry points. 

location | loc=<integer> 

Where integer is an absolute address. 

If no keyword is specified in the order dependent 
format, line number will be assumed. 

module | m: CYBIL-CC compilation unit to which line or label 
applies. If it is not specified, the default module is 
used. If address_expr is not specified, the base 
address is the beginning of the module. 

overlay | ovl: This specifies the overlay number in which the 
breakpoint is to be set. Default is to use the loaded 
overlays in the following order: 1) overlay which is 
currently being executed, 2) main overlay, 3) primary 
overlay, 4) secondary overlay. 

offset | o: A displacement which is added to the base address to 
form the effective memory address. Default is zero. 

first | f: The number of times the breakpoint must be reached 
before it is honored. Default is 1. 

last: The breakpoint will not be honored again after it has been 
reached this number of times. Default is infinity. 

step | s: Frequency parameter. Breakpoint will be honored every 
step times it is reached. Default is 1. 

collect | c: Activates collect mode to establish a body for this 
breakpoint. 

command_statement: CCDBG commands that make up the body of this 

breakpoint. 
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collect_end | ce: Terminates collect mode. 

Upon establishment of a breakpoint, a number is assigned. 
This breakpoint number, #n, is useful in referring to 
breakpoints, and is used in the breakpoint reporting message. 

When a breakpoint is reached and the frequency criteria are 
met, the breakpoint is honored. The message is: 

* B #n AT location 

where n is the breakpoint number, and location defines the 
location as specified in the SET_BREAKPOINT command. After 
issuing the message, CCDBG is ready to accept new commands. 

Examples: SB 10 

Sets a breakpoint at line 10 of the default module. 

SB e=simple offset=10 f=ll c 
DR b=4;PA;Ce 

Sets a breakpoint 10 locations after entrypoint 
simple. It is honored the 11th time it is reached, 
and each time thereafter. When the breakpoint is 
honored, register B4 is displayed and a pause is done. 

4.1.2 SET_TRAP | ST 

This command establishes a trap. It indicates the type of 
trap to be established and the scope of the trap. If the scope 
is not specified, the condition is trapped anywhere in the 
program. 

set_trap | st type=<trap_type> [scope_expr] 

[overlay=(<integer>,<integer>)] 

[module=<name>] [proc=<name> 

[.<name>] . . .] [ccollectxeol | ; > 
[<command_statementxeol | ;>]... 

<collect_end>] 

type: Specifies condition which will cause interruption of 

program execution. Trap_type must be one of the 
following. 
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OVERLAY | OVL 
END | E 
ABORT | A 
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INTERRUPT | INT 

INSTRUCTION | I 

LINE 

RJ 

XJ 

JUMP J 
READ R 
WRITE | W 

NOTE: If trap_type is OVERLAY or LINE, the keyword TYPE 
must be specified, since OVERLAY, OVL and LINE are also 
used as keywords in this command. 

scope_expr: This specifies where the trap is to apply. It is an 
address range which may be specified by any of the 
following: 

line | l=<integer>[<..><integer>] 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

location | loc=<integer>[<..><integer>] 

Where integer is an absolute address. 

offset o=<integer>[<..><integer>] 

Where integer is an address relative to a module. 

variable | var=<name> 

Where name is the identifier of the variable. This 
form is used for READ and WRITE type traps. NOTE: 
Dynamic variables are assigned only when the proc in 
which they are declared is active. Traps on dynamic 
variables should not remain established after the 
procedure completes. 

If the order dependent format is used and a keyword is 
not given, line will be assumed. 

overlay | ovl: If trap_type is OVERLAY, this specifies which 
overlay number to trap. For any trap_type other than 
overlay, it may be necessary to specify which overlay 
the address range applies to. Default is to use the 
loaded overlays in the following order: 1) overlay 
which is currently executing, 2) main overlay, 3) 
primary overlay, 4) secondary overlay. 

NOTE: Overlay numbers default to decimal on input. 

module | m: CYBIL-CC compilation unit to which scope_expr 
applies. If it is not specified, the default module is 
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used. 

proc | p: CYBIL-CC procedure name to which variable applies. 

Nested procedures may be referenced in the format 
procl.proc2.proc3, where proc3 is the desired 
procedure. If proc is not specified, the default proc 
is used. 

collect | c: Activates collect mode to establish a body for this 
trap. 

command_statement: CCDBG commands that make up the body of this 

trap. 

collect_end | ce: Terminates collect mode. 

Upon establishment of a trap, a number is assigned. This trap 
number, #n, is useful in referring to traps and is used in the 
trap message. A trap remains established for the remainder of 
the CCDBG session, unless it is redefined or cleared. 

When the condition specified in an established trap is 
encountered, trap action occurs. The message to the user is: 

* T #n, type trap_message xx location 

Where n is the trap number, type is the trap_type specified in 
the SET_TRAP command, trap_message is additional information 
depending on type, xx is AT or IN, and location identifies where 
the trap occurred. After issuing the message, CCDBG is ready to 
accept new commands. 

Examples: ST t=jump 1=30..70 

Sets a trap on jumps between line 30 and line 70 of 
the current default module. 

ST t=write var=test_result 

Sets a trap on writes into variable test_result. 

ST TYPE = LINE 

This example allows you to step through your program 
executing one line at a time. 

ST TYPE=LINE LINE=120..140 COLLECT 
CV #V1 #P-1 
DV #V1 F=ADR 
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COLLECT_END 

This example sets a trap on the execution of any of 
the lines specified in the scope range (120-140), and 
displays the line number that was trapped. 

ST type=line c 
CV #vl #p-l 
DV #vl f=adr 
GO 
ce 

This example creates a trace, displaying each line 
number as it is executed. 

4.1.3 DISPLAY_BREAKPOINT | DB 


This command lists all breakpoints in a program (or part of a 
program) or if a specific breakpoint number or a specific 
location is given the body of that breakpoint is displayed. 

display_breakpoint | db [address_expr] 

[b=<integer>[<..><integer>] 

(<integer>[<..><integer>] 

[<sepxinteger> [< . . ><integer>] ] . . . ) ] 

[offset=<integer>] 

[overlay^(<integer>,<integer>)] 
[module=<name>] 

address_expr: Specifies the location or range of locations to 

display breakpoints from. It must be one of the 
following: 

line | l=<integer>[<..><integer>] 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

location | loc=<integer>[<..><integer>] 

Where integer is an absolute address. 

entrypoint | e=<name> 

Where name is an entry point identifier. 

If the order dependent format is used and a keyword is 
not given, line will be assumed. 

b: The breakpoint number assigned when the breakpoint was 

established. 


4-6 

12/13/83 
REV: 1 


60460320 01 





4-7 

12/13/83 
REV: 1 


4.0 CCDBG COMMANDS 

4.1.3 DISPLAY_BREAKPOINT | DB 


CDC - SOFTWARE ENGINEERING SERVICES 
ERS for CYBIL-CC Interactive Debugger 


offset | o: A displacement that is added to the base address to 
form the effective memory address. Default is zero. 

overlay | ovl: This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the loaded overlays in the following order: 1) 
overlay which is currently executing, 2) main overlay, 
3) primary overlay, 4) secondary overlay. 

module | m: The CYBIL-CC compilation unit to which the line or 
offset parameter applies. If module is not specified, 
the default module is used. 

Examples: DB 3 

Displays the body of breakpoint number 3. 

DB overlay=(1,3) 

Lists all the breakpoints in overlay number (1,3). 

4.1.4 DISPLAY_TRAP | DT 


This command lists traps in all or part of the program; or, if 
a specific trap number or specific location is given, the body of 
that trap is listed. If traps from a range of locations are 
being listed, the user may have all types of traps listed, or may 
list only those traps of a specified type. 

display_trap | dt [type=<trap_type>] [scope_expr] 

[t=<integer>[<..><integer>] 

(<integer>[<..><integer>] 

[<sepxinteger> [< . . ><integer>] ] . . . ) ] 
[overlay=(<integer>,<integer>)] 
[module=<name>] [proc=<name> 

[.<name>]...] 

type: Specifies type of trap to be displayed. Trap_type must be 

one of the following: 


60460320 01 





CDC - SOFTWARE ENGINEERING SERVICES 
ERS for CYBIL-CC Interactive Debugger 


4.0 CCDBG COMMANDS 
4.1.4 DISPLAY_TRAP | DT 


OVERLAY | OVL 
END | E 
ABORT | A 
INTERRUPT | INT 
INSTRUCTION | I 
LINE 
RJ 
XJ 

JUMP J 
READ R 
WRITE | W 

If no type is specified, all types are displayed. 

NOTE: If trap_type is OVERLAY or LINE, the keyword TYPE 
must be specified, since OVERLAY, OVL and LINE are also 
used as keywords in this command. 

scope_expr: Specifies the location or range of locations to 
display traps from. It must be one of the following: 

line | l=<integer>[<..><integer>] 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

location | loc=<integer>[<..><integer>] 

Where integer is an absolute address. 

offset | o=<integer>[<..><integer>] 

Where integer is an address relative to a module. 

variable | var=<name> 

Where name is the identifier of the variable. 

If the order dependent format is used and no keyword is 
given, line will be assumed. 

t: The trap number assigned when the trap was established. 

overlay | ovl: This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the loaded overlays in the following 
order: 1) overlay which is currently executing, 2) 

main overlay, 3) primary overlay, 4) secondary overlay. 
NOTE: Overlay numbers default to decimal on input. 

module | m: The CYBIL-CC compilation unit to which the line or 
offset parameter applies. If it is not specified, the 
default module is used. 
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proc | p: The CYBIL-CC procedure name to which variable applies. 

If not specified, the default proc is used. Nested 
procs may be referenced in the format 
procl.proc2.proc3, where proc3 is the desired 
procedure. 

Examples: DT m=my_mod 

Lists all traps of any type in module my_mod. 

DT type=rj 


Lists all RJ traps set in the program. 


4.1.5 SAVE_BREAKPOINT | SAVEB 


This command saves the breakpoint definition on a local file. 
Either specific breakpoints or all breakpoints in the program or 
part of the program may be saved. If the breakpoint has a body, 
it will also be saved. If no qualifying parameters are 
specified, all breakpoints will be saved. 

save_breakpoint | saveb file=<name> [scope_expr] 

[b=<integer>[<..><integer>] 

(<integer>[<..><integer>] 
[<sepxinteger> [< . . ><integer>] ] . . . ) ] 

[offset=<integer>] 

[overlay=(<integer>,<integer>)] 
[module=<name>] 

file | f: The name of a local file to write breakpoint 
definitions on. 

scope_expr: This specifies the location or range of locations to 

save breakpoints from. It must be one of the 
following: 

line | l=<integer>[<..><integer>] 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

location | loc=<integer>[<..><integer>] 

Where integer is an absolute address. 

entrypoint | e=<name> 

Where name is an entry point identifier. 

If the order dependent format is used and no keyword is 
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given, line will be assumed. 

b: The breakpoint number assigned when the breakpoint was 

established. 

offset | o: A displacement that is added to the base address to 
form the effective memory address. Default is zero. 

overlay | ovl: This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the loaded overlays in the following order: 1) 
overlay which is currently executing, 2) main overlay, 
3) primary overlay, 4) secondary overlay. 

module | m: The CYBIL-CC compilation unit to which line or offset 
apply. If it is not specified, the default module is 
used. 

Examples: SAVEB f=bpfile b=(2,3) 

Saves breakpoints number 2 and number 3 on local file 
BPFILE. 

SAVEB,bps,10. .40, , , (1,3) ,xyzl2 

Saves on file BPS, all breakpoints in lines 10 to 40 
which are in module xyzl2 on overlay (1,3). 

4.1.6 SAVE_TRAP | SAVET 


This command saves the trap definition on a local file. 
Either specific traps or all traps in the program or part of the 
program may be saved. All traps may be saved, or just one type 
of trap may be saved. If a trap has a body, it will also be 
saved. If no trap number, type, or scope_expr is specified, all 
traps will be saved. 

save_trap | savet file=<name>[type=<trap_type>] 

[scope_expr] 

[t=<integer>[<..><integer>] 

(<integer>[<..><integer>] 

[<sepxinteger> [< . . ><integer>] ] . . . ) ] 
[overlay=(<integer>,<integer>)] 
[module=<name>] [proc=<name> 

[.<name>]...] 

file | f: The local file to write trap definitions to. 
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type: Specifies the type of trap to be saved. Trap_type must be 
one of the following. 

OVERLAY | OVL 
END | E 
ABORT | A 
INTERRUPT | INT 
INSTRUCTION | I 
LINE 
RJ 
XJ 

JUMP J 
READ R 
WRITE | W 

If no type is specified, all types are saved. 

NOTE: If trap_type is OVERLAY or LINE, the keyword TYPE 
must be specified, since OVERLAY, OVL and LINE are also 
used as keywords in this command. 

scope_expr: This specifies the location or range of locations to 

save traps from. It must be one of the following: 

line | l=<integer>[<..><integer>] 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

location | loc=<integer>[<..><integer>] 

Where integer is an absolute address. 

offset | o=<integer>[<..><integer>] 

Where integer is an address relative to the beginning 
of a module. 

variable | var=<name> 

Where name is the identifier of the variable. This 
form is used for READ and WRITE traps. 

If the order dependent format is used and no keyword is 
given, line will be assumed. 

t: The trap number assigned when the trap was established. 

overlay | ovl: This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the loaded overlays in the following order: 1) 
overlay currently executing, 2) main overlay, 3) 
primary overlay, 4) secondary overlay. 
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NOTE: Overlay numbers default to decimal on input. 

module | m: The CYBIL-CC compilation unit to which the line or 
offset parameter applies. If it is not specified, the 
default module is used. 

proc | p: The CYBIL-CC procedure name to which var applies. If 
it is not specified, the default proc is used. Nested 
procedures may be referenced in the format 

procl.proc2.proc3, where proc3 is the desired 

procedure. 

Examples: SAVET write 

Save all traps of type write. 

SAVET module=l_test 

Saves all traps in module l_test. 

4.1.7 CLEAR_BREAKPOINT | CB 


This command clears specific breakpoints, or all breakpoints 
in the program or part of the program. If no parameters are 
specified, a warning message will be issued. If the user accepts 
the warning, all breakpoints will be cleared. 

clear_breakpoint | cb [scope_expr] 

[b=<integer>[<..><integer>] 

(<integer>[<..><integer>] 
[<sepxinteger> [< . . ><integer>] ] . . . ) ] 

[offset=<integer>] 

[overlay=(<integer>,<integer>) ] 
[module=<name>] 

scope_expr: This specifies the location or range of locations to 

clear breakpoints from. It must be one of the 
following: 

line | l=<integer>[<..><integer>] 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

location | loc=<integer>[<..><integer>] 

Where integer is an absolute address. 

entrypoint | e=<name> 

Where name is an entry point identifier. 
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If the order dependent format is used and no keyword is 
given, line will be assumed. 

b: The breakpoint number assigned when the breakpoint was 

established. 

offset | o: A displacement that is added to the base address to 
form the effective memory address. Default is zero. 

overlay | ovl: This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the loaded overlays in the following order: 1) 
overlay currently executing, 2) main overlay, 3) 
primary overlay, 4) secondary overlay. 

module | m: The CYBIL-CC compilation unit to which line or offset 
and proc apply. If it is not specified, the default 
module is used. 

Examples: CB b=l 

Clears breakpoint number 1. 

CB line=17 offset=4 

Clears breakpoint at 4 words past the word containing 
the first instruction generated by the statement at 
line 17. 

4.1.8 CLEAR_TRAP | CT 


This command clears specified traps or all traps in the 
program or part of the program. All types of traps may be 
cleared or one type may be specified. If no parameters are 
specified, a warning message will be issued. If the user accepts 
the warning, all traps will be cleared. 

clear_trap | ct [type=<trap_type>][scope_expr] 

[t=<integer>[<..><integer>] 

(<integer>[<..><integer>] 

[<sepxinteger> [< . . ><integer>] ] . . . ) ] 

[overlay=(<integer>,<integer>)] 

[module=<name>] [proc=<name> 

[.<name>]...] 

type: Specifies type of trap to be cleared. Trap_type must be 

one of the following. 
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OVERLAY | OVL 
END | E 
ABORT | A 
INTERRUPT | INT 
INSTRUCTION | I 
LINE 
RJ 
XJ 

JUMP J 
READ R 
WRITE | W 

If no type is specified, all types are cleared. 

NOTE: If trap_type is OVERLAY or LINE, the keyword TYPE 
must be specified, since OVERLAY, OVL and LINE are also 
used as keywords in this command. 

scope_expr: This specifies the location or range of locations to 
clear traps from. It must be one of the following: 

line | l=<integer>[<..><integer>] 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

location | loc=<integer>[<..><integer>] 

Where integer is an absolute address. 

offset | o=<integer> [<..><integer>] 

Where integer is an address relative to a module. 

variable | var=<name> 

Where name is the identifier of the variable. This 
form is used for READ and WRITE type traps. 

If the order dependent format is used and no keyword is 
given, line will be assumed. 

t: The trap number assigned when the trap was established. 

overlay | ovl: This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the loaded overlays in the following order: 1) 
overlay currently executing, 2) main overlay, 3) 
primary overlay, 4) secondary overlay. 

NOTE: Overlay numbers default to decimal on input. 

module | m: The CYBIL-CC compilation unit to which the line, 
offset, or proc parameter applies. If it is not 
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specified, the default module is used. 

proc | p: The CYBIL-CC procedure name to which variable applies. 

If it is not specified, the default proc is used. 
Nested procs may be referenced in the format 
procl.proc2.proc3, where proc3 is the desired 
procedure. 

Examples: CT type=overlay 

Clears all traps of type overlay in the program. 

CT t = instruction loc=1653(8) . .1700 (8) 

Clears any traps of type INSTRUCTION in the address 
range 1653 to 1700. 

4.1.9 SET_INTERPRET | SI 

Allows the CCDBG user to explicitly control the use of 
interpret mode. Interpret mode is turned on by the SET_INTERPRET 
command. 

Interpret mode is also turned on when any trap of types RJ, 
XJ, JUMP, WRITE, READ, or INSTRUCTION are established. 

If a CLEAR_INTERPRET command is subsequently issued, the traps 
are made inoperative until a SI command is issued, when they 
again become operative. 

4.1.10 CLEAR_INTERPRET | Cl 


Clears interpret mode. 

4.2 DISPLAYING AND CHANGING PROGRAM VARIABLES 


4.2.1 DIS PLAY_VARIABLE | DV 


This command displays the values of CYBIL-CC identifiers in a 
format corresponding to their program defined type, or in a 
memory format specified by the user. Fields of records may be 
referenced using the same notation used in CYBIL-CC (including 
pointer notation). Array elements may be referenced using a 
subscript only if the subscript is a constant of the same type as 
the array index. Variables are not allowed as subscripts. 
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display_variable | dv [var=<name>] 

[format=oct | dec | hex] [module=<name>] 
[proc=<name>] [.<name>]...] 

variable | var: Name of the program variable to display. It will 
be displayed in a format corresponding to its program 
defined type. These types and corresponding formats 
are: 


integer - signed decimal integer 
character - ascii character enclosed in single 
quotes. 

ordinal - name composed of ascii characters 
boolean - true or false 
pointer - octal digits 

set - each element is displayed as listed above, 
depending on its defined type, 
string - ascii characters enclosed in single 
quotes 

sequence - octal digits 

array - each item is displayed as above, 
depending on its defined type, 
record - each field is displayed as above 
depending on its defined type. 

If no variable name is specified, a list of variables 
will be displayed. What variables are displayed 
depends upon which other parameters are specified. If 
var is not specified, and proc is, then all variables 
local to the specified proc are displayed. If only 
module is specified then only variables at the module 
level are displayed. If no parameters are specified, 
local symbols for the current default are displayed. 
This may be either procedure level or module level 
depending on the current default value. 

format | f: Specifies the format in which to display the 
variable. One of these three: 

oct: Octal digits followed by (8) 

dec: Signed decimal integer 

hex: Hexadecimal digits followed by (16) 

If this parameter is specified, it overides the program 
defined type format. 

module | m: The CYBIL-CC compilation unit to which var applies. 

If it is not specified, the default module is used. 
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proc | p: The CYBIL-CC procedure name to which var applies. If 
it is not specified, the default proc is used. Nested 
procedures may be referenced in the format 

procl.proc2.proc3, where proc3 is the desired 

procedure. 

Example: DV var=i proc=calculate_subscript 

Displays variable I in format corresponding to its 
program defined type. Variable I is in proc 
calculate_subscript. 

4.2.2 CHANGE_VARIABLE | CV 


This command changes the memory locations at the address of 

the CYBIL-CC identifier. Subscripted references and field 

references may be made in the same way as in DISPLAY_VARIABLE. 

change_variable | cv var=<name> value=<expr> 

[module=<name>] [proc=<name> 

[.<name>]...] 

variable | var: Name of the user variable to change. 

value | v: The decimal, octal or ascii value to be stored at the 
specified variable. The format of the value must match 
the type of the variable (see list under 
Display_Variable). For boolean variables, only the 
values 'true' and 'false' are valid. For a set 
variable, the value specifies an element of the set 
that is to be added to or deleted from the set. 

module | m: The CYBIL-CC compilation unit to which var applies. 

If it is not specified, the default module is used. 

proc | p: The CYBIL-CC procedure name to which var applies. If 
it is not specified, the default proc is used. Nested 
procedures may be referenced in the format 
procl.proc2.proc3, where proc3 is the desired 

procedure. 

Example: CV var=x_string value='zero' 

Changes variable x_string to the string zero. x_string 
is in the default module and proc. 
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The DISPLAY_MEMORY, FORWARD and BACKWARD commands maintain a 
single default memory address and a default format. After being 
set by a DM command, these values are used by FORWARD and 
BACKWARD. This allows other commands to be used between any 
memory display commands without losing the position or format of 
the memory being displayed. The memory address and format are 
updated by each FORWARD, BACKWARD or DM command. Specifying a 
format type on a FORWARD or BACKWARD command means that format 
will be the default until a new format is specified. 

4.3.1 DISPLAY_MEMORY | DM 


This command displays the contents of a specified number of 
words beginning at a specified address. 

display__memory | dm <address_expr> 

[format=oct | dec | adr | hex] 

[numlocs=<integer>] 

[offset=<integer>] [module=<name>] 
[indirect] 

address_expr: The address specified by this parameter is known as 
the base address. Any one of the following forms may 
be used. 


location | loc=<integer> 

Where integer is an absolute address. 

line | l=<integer> 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

ecs = <integer> 

Where integer is an ECS address. 

entrypoint | e=<name> 

Where name is an entry point identifier. 

If the order dependent format is used and no keyword is 
given, location will be assumed. 

format | f: Format of the memory display. It must be one of the 
following. 

oct: Octal digits followed by (8) 
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dec: Signed decimal integer 

adr: Lower 18 bits are displayed as an address 
hex: Hexadecimal digits followed by (16) 

Default format is oct. 

numlocs | n: This specifies the number of memory locations to be 
referenced. Default is one. 

offset | o: A displacement which is added to the base address to 
form the effective memory address. Default is zero. 

module | m: CYBIL-CC compilation unit to which line or offset 
applies. If it is not specified, the default module is 
used. 

indirect | i: This specifies that the display is to be at the 
memory location addressed by the contents of the base 
address. 

Example: DM e=cdta,offset=4,f=oct,n=10 

Displays ten words of memory in octal digits beginning 
four words after entrypoint cdta. 

4.3.2 FORWARD | FW 


This command continues the memory display forward from the 
last DM, FORWARD or BACKWARD command. Displays memory starting 
with the word following the last word displayed by the previous 
command. 

forward | fw numlocs=<integer> 

[format=oct | dec | adr | hex] 

numlocs | n: Specifies the number of memory locations to be 
referenced. 

format | f: Format of the memory display. It must be one of the 
following: 

oct: Octal digits followed by (8) 
dec: Signed decimal integer 
adr: Displays lower 18 bits as an address 
hex: Hexadecimal digits followed by (16) 

Default value for format is to continue in the same 
format as the previous display_memory, forward, or 
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backward command. 

Example: FORWARD 6 

Displays the next 6 words of memory in the same format 
as the previous DISPLAY_MEMORY, FORWARD or BACKWARD. 

4.3.3 BACKWARD | BW 
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This command continues the memory display with the section of 
memory preceding the current display memory location. It 
displays memory from the word preceding the first word displayed 
by the previous command back n locations. 

backward | bw numlocs=<integer> 

[format=oct | dec | adr | hex] 

numlocs | n: Specifies the number of memory locations to be 
referenced. 

format | f: Format of the memory display. It must be one of the 
following: 

oct: Octal digits followed by (8) 
dec: Signed decimal integer 
adr: Displays lower 18 bits as an address 
hex: Hexadecimal digits followed by (16) 

Default value for format is to continue in the same 
format as the previous display_memory, forward, or 
backward command. 

Example: BACKWARD 4,oct 

Displays the four preceding words of memory in octal 
format. 

4.3.4 CHANGE_MEMORY | CM 

This command changes the contents of the specified memory 
locations. 

change_memory | cm <address_expr> 

[module=<name>] [offset=<integer>] 
value=<expr> [numlocs=<integer>] 

[indirect] 
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address_expr: The address specified by this parameter is known as 
the base address. Any one of the following forms may 
be used. 

location | loc=<integer> 

Where integer is an absolute address. 

line | l=<integer> 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

entrypoint | e=<name> 

Where name is an entry point identifier. 

ecs = <integer> 

Where integer is an ECS address. 

If the order dependent format is used and no keyword is 
given, location is assumed. 

module | m: The CYBIL-CC compilation unit to which line applies. 

offset | o: A displacement which is added to the base address to 
form the effective memory address. Default is zero. 

value | v: The octal, decimal, hexadecimal or ascii value which 
is to be stored at the memory address specified. 

numlocs | n: This specifies the number of memory locations to be 
changed. Default is one. 

indirect | i: This specifies that the location to be changed is 
the memory location addressed by the contents of the 
base address. 

Example: CM loc=6270(8) v=1493 

Stores 1493 (note default base is decimal) in octal 
address 6270. 

4.3.5 DISPLAY_REGISTERS | DR 


This command displays the contents of the machine registers. 

display_registers dr [p | fl | [a | b | x=[<integer>]]] 

[format=oct | dec | adr | hex] 
[indirect] 
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p | fl | a | b | x: This specifies which type of register is to 
be displayed. The number for a, b, or x, indicates 

which register number to display. If no register 
number is specified, all of the specified type will be 
displayed. If the parameter is omitted, all 24 A, B, 
and X registers will be displayed. 

format | f: Format of the register display. It must be one of 
the following: 

oct: Octal digits followed by (8) 
dec: Signed decimal integer 

adr: Displays the lower 18 bits as an address 
hex: Hexadecimal digits followed by (16) 

Default value of format is octal for a, b, and x 
registers, and address for p and fl registers. 

indirect | i: This specifies, if quoted, that the display is to 
be at the memory location addressed by the contents of 
the register. 


Example: DR b 

Displays all b registers in octal format. 


4.3.6 CHANGE_REGISTERS | CR 


This command changes the contents of the machine registers. 

change_registers cr a | b | x=<integer> 

value=<expr> [indirect] 

a | b | x: This specifies which type of register is to be 
changed. The integer specifies the register number to 
be changed. 

value | v: This is the octal, decimal, hexadecimal or ascii value 
to be stored in the register. 

indirect | i: This specifies, if quoted, that the value is to be 
stored at the memory location addressed by the contents 
of the register. 

Example: CR x=6 v=1236(8) 

Places the value 1236 (octal) in register x6. 
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4.4 DEBUGGER SCL PROCEDURES 

A debugger SCL procedure is a named sequence of CCDBG commands 
that is established within the CCDBG environment. Any desired 
CCDBG command sequence can be established as a debugger SCL 
procedure. Procedures can be invoked either from within some 
other procedure or from the terminal when in interactive command 
input mode, by issuing a READ command referencing the name of the 
defined procedure. 

4.4.1 SET_PROCEDURE | SP 


This command establishes a debugger SCL procedure. 

set_procedure | sp procedure=<name> [ccollectxeol | ; > 

[<command_statementxeol | ; >] . . . ] 

<collect_end> 

procedure | pr: The identifier assigned to this sequence of CCDBG 
commands. 

collect | c: Activates collect mode. This parameter is not 
necessary to establish a procedure, but is included in 
the syntax for compatibility with SET_TRAP and 
SET_BREAKPOINT commands. 

command_statements: CCDBG commands which make up the body of the 
procedure. They are checked for syntax but not 
executed at this time. 

collect_end | ce: Terminates collect mode. This parameter is 
required. 

Example: SET_PROCEDURE procedure=newid; DR b=5; DV var=x;dv y; 

PA; ce 

Creates a procedure named newid which contains several 
commands. 

4.4.2 DISPLAY_PROCEDURE | DP 


This command displays the commands that make up the specified 
procedure. If no procedure identifier is specified, the names of 
all existing debugger SCL procedures are displayed. 

display_procedure | dp [procedure=<name> | 
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(<name> [<sepxname>] . . . ) ] 

procedure | pr: The identifier of the procedure to be displayed, 
as specified in the SET_PROCEDURE command. 

Example: DP procedure=newid 

Displays the debugger SCL procedure named newid. 

4.4.3 SAVE_PROCEDURE | SAVEP 
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This command copies specified procedure definitions to a local 
file. If no procedures are specified, all debugger SCL 
procedures are copied to the file. 

save_procedure | savep file=<name> [procedure=<name> | 

(<name> [<sepxname>] . . . ) ] 

file | f: The name of the file the procedure is to be saved on. 
procedure | pr: The identifier of the group to be saved. 

Example: SAVEP procedure=newid f=saveid 

Saves procedure named newid on file saveid. 

4.4.4 CLEAR_PROCEDURE | CP 


This command removes specified debugger SCL procedure 
definitions. If no procedure is specified, a warning message is 
issued, and if the user accepts the warning, all debugger SCL 
procedures are cleared. 

clear_procedure | cp [procedure=<name> | 

(<name> [<sepxname>] . . . ) ] 

procedure | pr: The identifier of the procedure to clear, as 
specified on the SET_PROCEDURE command. 

Example: CP procedure=newid 

Clears debugger SCL procedure newid. 

4.5 DEBUGGER SCL PROCEDURE COMMANDS 


A procedure is a set of CCDBG commands established as a 
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debugger SCL procedure. Once initiated, the commands in a 
procedure execute automatically. 

Any CCDBG command may be used in a procedure. Most of the 
following commands, however, are particularly designed for use in 
a procedure. 

4.5.1 PAUSE | PA 


This command temporarily suspends the automatic execution of 
the current CCDBG procedure and enters interactive mode, allowing 
CCDBG commands to be entered from the terminal. 

On the occurrence of the first PAUSE command in a procedure 
body of a trap or breakpoint, the appropriate trap or breakpoint 
report is issued prior to entering interactive mode. 

pause | pa [text='[<ascii>]...'] 

text | t: Message text to be issued when pause is executed. The 
text may be any string of characters. It is delimited 
by a pair of apostrophes ( 1 ). Apostrophes within the 
text are indicated by two consecutive occurrences of 
the character. 

Example: PAUSE text='x3 is new value of I' 

4.5.2 MESSAGE | ME 


This command issues a designated message to the users terminal 
during a procedure execution. 

message | me [text=' [<ascii>] ... '] 

text | t: Message text to be issued when the command is executed. 

The text may be any string of characters. It is 
delimited by a pair of apostrophes (')■ Apostrophes 
within the text are indicated by two consecutive 
occurrences of the character. 

Example: MESSAGE 'Variable XYZ has been modified' 

4.5.3 GO 


This command causes an exit from the current debugger SCL 
procedure or interactive mode and a resumption of suspended 
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processing. The current debugger SCL procedure may have been 
invoked by a read, in which case the processing will be resumed 
with the statement following the read. 

If the GO command is issued from a breakpoint or trap body, 
program execution is resumed. In this last case, GO is identical 
to the Execute command. Resumption of program execution can be 
specified via the optional address parameter. 

go [address_expr][offset=<integer>] 

address_expr: Address at which execution is to resume. It is not 
possible to resume execution in a different module or 
procedure. Address_expr may be any of the following: 

line | l=<integer> 

Where integer is the CYBIL-CC line number generated 
by the compiler. 

location | loc=<integer> 

Where integer is an absolute address. 

entrypoint | e = <name> 

Where name is an entry point identifier. 

If no keyword is given for address_expr, line will be 
assumed. 

offset | o: A displacement added to the base address specified by 
address_expr. 

Example: GO line=42 offset=3 

4.5.4 SKIPIF | S 


This command conditionally skips the following command when 
the specified relation is satisfied. 

skipif | s <value_lxrelationxvalue_2> 

value_l | vl: An integer expression. It may include CCDBG 
variables, but not program variables. 

relation: One of the following: 
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= Equal 

<> Not equal 

< Less than 

<= Less than or equal 

>= Greater than or equal 

> Greater than 

value_2 | v2: An integer expression. It may include CCDBG 
variables, but not program variables. 

Example: SKIPIF #V1 < 20 

Skips next command if the value of CCDBG variable #V1 
is less than 20. 

4.5.5 LABEL | LA 

This command defines an identifier for the location in the 
procedure where it occurs. 

Labels are local to the procedure in which they occur. No 
check is made for duplicate labels. 

label | la name=<name> 

name | n: Identifier to be used for this location. 

Example: LABEL n=bl013 

Establishes label B10L3 at the current location in the 
procedure. 

4.5.6 GOTO 


This command transfers control to the specified label within a 
procedure. Control can be transferred either forwards or 
backwards. Search is forward, end around, until the first 
occurrence of the label is found. 

goto label=<name> 

label | la: Identifier of location to which control is 

transferred. 

Example: GOTO bl013 

Transfers control to the location of label B10L3 
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This command is used in three different ways: 

1) To process CCDBG commands stored or modified by some facility 
not provided by CCDBG itself (e.g., the editor). 

2) To reconstitute breakpoint, trap, and debugger SCL procedure 
definitions previously SAVEd on a file. 

3) To invoke a debugger SCL procedure. 

read | r file | procedure = <name> 

file | f: Name of file containing commands to be executed. 

procedure | pr: Name of procedure to be executed. 

Examples: READ f=bpfile 

Re-establishes breakpoint definitions saved on BPFILE. 
READ procedure=newid 

Initiates processing of procedure NEWID. 


4.6 ADDITIONAL INTERACTIVE MODE COMMANDS 
4.6.1 EXECUTE | EX 


This command starts or resumes program execution. Program 
execution is initiated at the next instruction, or at the user 
specified address. This command differs from the GO command when 
there are higher levels of CCDBG commands. GO transfers control 
to the next higher level of CCDBG commands, EXECUTE bypasses all 
CCDBG commands to resume program execution. 

execute | ex [address_expr] [offset=<integer>] 

address_expr: An address at which execution is to resume. It is 
not possible to resume execution in another module or 
procedure. It may be any of the following: 

line | l=<integer> 

Where integer is the CYBIL-CC line number generated 
by the compiler. 
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location | loc=<integer> 

Where integer is an absolute address. 

entrypoint | e = <name> 

Where name is an entry point identifier. 

If no keyword is given for address_expr, line will be 
assumed. 

offset | o: A displacement added to the base address. 

Example: EX 146 

Resume execution at line 146 relative to the current 
executing module. 

4.6.2 TRACEBACK | TB 


This command produces a list of CYBIL-CC procedure names, 
beginning with the currently executing CYBIL-CC procedure and 
moving backward through successive levels. 

traceback | tb [entrypoint=<name>] 

entrypoint | e: If a non-CYBIL-CC routine has multiple 
entrypoints, this parameter specifies at which 
entrypoint to start the traceback. 

Example: TB 

Lists all calls beginning with the most recent and 
going backward as far as possible. 

4.6.3 MOVE | M 


This command moves values from one address range to some other 
address range or location. The action taken depends on whether 
either the source or destination parameter is a range 
specification. 

If the source or destination is a range specification, the 
numlocs parameter is ignored even if present and enough words are 
moved from the source to fill the destination range. If the 
source range is smaller than the destination range, the words are 
moved repeatedly until the destination range is filled. If the 
source range is larger, only as many words as are needed are 
moved. 


60460320 01 





CDC 


SOFTWARE ENGINEERING SERVICES 


4-30 


12/13/83 

ERS for CYBIL-CC Interactive Debugger REV: 1 


4.0 CCDBG COMMANDS 
4.6.3 MOVE | M 


If neither the source nor destination is a range 

specification, the numlocs parameter determines the number of 

words to move. 

move | m source_expr destination_expr 

[numlocs=<integer>] 

source_expr: Address or address range expression from which to 
move values. Must have one of the following forms: 

source_line | sl=<integer>[<..><integer>] 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

source_offset | so=<integer>[<..><integer>] 

Where integer is an address relative to a module. 

source_location | sloc=<integer>[<..><integer>] 

Where integer is an absolute address. 

If a keyword is not specified, source_location is 
assumed. 

destination_expr: Address or address range expression to which 

values are to be moved. Must have one of the following 
forms: 

destination_line | dl=<integer>[<..><integer>] 

Where integer is a CYBIL-CC line number generated by 
the compiler. 

destination_offset | do=<integer>[<..><integer>] 

Where integer is an address relative to a module. 

destination_location | dloc=<integer>[<..><integer>] 
Where integer is an absolute address. 

If a keyword is not specified, destination_location is 
assumed. 

numlocs | n: Number of words to be moved if neither the source 
nor the destination is an address range. Default is 
one. 

Example: MOVE sloc=112 (8) . .120 (8) dloc=142(8) . .150 (8) 

Moves 7 words beginning at 112(octal) to a 7 word field 
beginning at location 142(octal), all addresses are 
absolute. 
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This command can provide immediate assistance to a terminal 
user about CCDBG features. It acts as a selectively accessed 
on-line information summary. 

help | h [<subject> | <command_name>] 

<subject>: One of the permissible subject categories. 

<command_name>: A CCDBG command identifier or abbreviation. 

If no parameter is specified, the subject index is listed. 
This displays all the permissible subject catagories that may be 
entered as parameters to help. 

Example: HELP cmds (lists all CCDBG command identifiers) 

4.6.5 SAVE_ALL | SAVEA 


This command saves all trap, breakpoint and debugger SCL 
procedure definitions. 

save_all | savea file=<name> 

file | f: The name of a local file on which to save the 
environment. 

Example: SAVEA,bigfile 

4.6.6 CHECKPOINT | CK 


This command allows a user to save the CCDBG information 
necessary to return to the debug session at a later time. 

CHECKPOINT saves the current CCDBG environment (breakpoint, 
trap, and debugger SCL procedure definitions), and current status 
(interpret and veto mode settings), output options, default 
module, default proc, CCDBG variables and tables, and the user 
program image, on a file. 

Restoration of CCDBG to its status, environment, and user 
program image is done by issuing the system command DEBUG(RESUME, 
filename). 

checkpoint | ck file=<name> 
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file | f: The name of a local file on which the CCDBG environment 
will be saved. 


Example: CHECKPOINT f=sf 

4.6.7 QUIT 


This command terminates a CCDBG session. 

quit [normal | abort] 

normal: Terminate normally. This is the default if no parameter 

is specified. 

abort: Causes an abort type of termination to occur. This allows 
abort processing if CCDBG is being used in a batch job, 
or from a procedure file. 

4.7 CCDBG ENVIRONMENT COMMANDS 

4.7.1 SET_VETO | SVE 


This command provides a method of CCDBG sequence operation 
that combines the automatic and interactive modes. When veto 
mode is on, each command in a CCDBG sequence is displayed before 
it is executed. The user is given temporary control at this 
point. The user may allow the command to be executed, skip it, 
or replace it with one or more new commands. 

set_veto | sve 

4.7.2 CLEAR_VETO | CVE 


This command terminates veto mode. 

4.7.3 SET_OUTPUT | SO 


This command allows the user to control the kinds of CCDBG 
output that are written to the standard output file. 

set_output | so lo=<options> 

lo: List options, any of the following: 
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e Error messages 
w Warning messages 

d Debug output produced by command execution 
i Informative messages 

r Read command sequence (group or file) when read 

b Body sequence when it occurs (trap or breakpoint) 

t Terminal or standard input file echo 

The default options when the list is omitted are 
e,w,d,i. If e is omitted, an auxiliary file must be 
defined with the e option specified. 

Example: SO lo=(e,w,i) 

4.7.4 S E T_AUXILIARY | SAUX 
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This command allows a user to define an optional auxiliary 
output file and control the kinds of output that are written to 
it. 

set_auxiliary | saux file=<name> lo=<options> 

file | f: Name of the file to be the auxiliary output file. 

lo: List options. These define what is to go on the file. Any 
of the following: 

e Error messages 
w Warning messages 

d Debug output produced by command execution 
i Informative messages 

r Read command sequence (group or file) when read 

b Body sequence when it occurs (trap or breakpoint) 

t Terminal or standard input file echo 

Example: SAUX f=pxidaux lo=(d,r) 

4.7.5 C L EAR_AUXILIARY | CAUX 

Closes the current auxiliary file and clears all the auxiliary 
options. 

4.7.6 DISPLAY_MAP | DMAP 


This command displays load map information relating to modules 
entry points, and overlays. 
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display__map | dmap [module=<name>] 

[overlay=(<integer>,<integer>)] 

module | m: A CYBIL-CC compilation unit. If a module is 
specified, its origin, length and all entry points 
contained in it are displayed. 

overlay | ovl: If an overlay is specified, the names of all 
modules in the overlay are listed. 

If no parameter is specified in a non_overlay environment, the 
names of all modules are listed. In an overlay environment, 
designations of overlays are listed. 

Example: DMAP m=adapt 

Displays loader information about module adapt. 

4.7.7 DISPLAY_DEFAULTS | DD 
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This command displays the current default value for module and 
proc. 

4.7.8 DISPLAY_STATUS | DS 


This command displays information to help the user determine 
the current state of the debug session. 

display_status | ds 

The following information is displayed. 

The location of the trap or breakpoint currently 
honored, or the location of user program abort or 
interrupt to be displayed. 

The overlay numbers currently in core and their 

addresses. 

The current terminal output options. 

The name of the current auxiliary output file and the 
current auxiliary output options. 

The current state of veto mode (on or off). 

The current state of interpret mode (on or off). 
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The number of breakpoints, traps, and groups currently 
defined. 

4.7.9 CHANGE_DEFAULTS | CD 


This command allows the user to change the default values of 
module and proc to new identifiers. 

change_defaults | cd [module=<name>] 

[proc=<name>] [<.name>]...] 

[overlay=(<integer>,<integer>)] 

module | m: This parameter changes the default module from the 
specified module. 

proc | p: This parameter changes the default proc to the 
specified proc. 

overlay | ovl: Overlay which contains the new default module or 
proc. 

Example: CD m=zclmtay 

Changes default module to the module with alias 
zclmtay. 
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5.1 DIAGNOSTIC MESSAGES 


Diagnostic messages issued by CCDBG are listed below. These 
messages are issues in one of the following forms: 

*ERROR - message text 


*CMD - (command text) *ERROR - message text 


When in collect mode, some errors, such as those involving 
invalid syntax, are detected and reported prior to being 
collected, thus allowing them to be corrected at that time. 
Other errors are not detected until execution of the command is 
attempted. 

Message Significance and Action 

ADDRESS IN GO or EXECUTE has been supplied with a location 
ECS/LCM parameter that is an ECS or LCM address. If sup¬ 

plied, the address must be one in central memory. 

ACTION: Correct and reenter. 

ADDRESS IN A specified symbolic address implies one contained 
UNLOADED in an overlay not currently loaded. 

OVERLAY 

ACTION: Confine symbolic addresses to those in 

currently loaded overlays. 

ADDRESS An address reference is to a location in DBUG, 

OUTSIDE beyond the first 100B (approximately) locations, 

USER AREA or beyond the user field length. These locations 
are inaccessible to the user. 

ACTION: Reenter with an allowable address. 

BAD INDEX Internal error. 

TYPE i 

ACTION: Submit PSR. 

BAD A variable of type ordinal contains an 

ORDINAL undefined value. 
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VALUE i 

ACTION: None. 

BAD SYMBOL Internal error. 

TYPE i 

ACTION: Submit PSR 

The CHANGE_VARIABLE command can only change the 
value of simple variables, such as fields of 
records or elements of arrays. 


ACTION: Reenter with subscript or field notation. 

CANNOT Internal error. 

EVALUATE 
VARIABLE 
TYPE i 

ACTION: Submit PSR. 

DEBUG An error in Debug is preventing further pro- 

INTERNAL cessing. Debug must be aborted. The program 

ERROR being debugged could have damaged a portion of DBUG. 

ACTION: Try a new Debug session with all execution 

performed in interpret mode, which protects 
DBUG. code. 

ERROR Completing the current SET OUTPUT, SET 

MESSAGES AUXILIARY, CLEAR OUTPUT, or CLEAR 
MAY NOT BE AUXILIARY command results in no file being 
SUPPRESSED designated to receive error messages. 

ACTION: Assign file options consistent with this 

restriction. 

EXECUTION The address specified is outside the current 
ADDRESS procedure, and execution of the command would 

OUTSIDE invalidate the stack. 

CURRENT 

PROCEDURE 

ACTION: Correct and reenter. 


CANNOT 
CHANGE 
VALUE OF 
ENTIRE 
RECORD OR 
ARRAY 
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INVALID An illegal descriptor word was found for 

DESCRIPTOR an adaptable array. 

WORD FOR 

ADAPTABLE 

ARRAY 

ACTION: Use a write trap on the pointer to find the 

point where the descriptor is destroyed. 

A breakpoint has been supplied with an invalid 
frequency parameter. 


ACTION: Check that all such parameters are positive. 

Check that LAST is not less than FIRST. 
Reenter with corrected values. First is 
limited to 262,143. Step is limited to 
4095. 

INVALID The value input is not a valid value for this 

ORDINAL variable. 

VALUE x 

ACTION: Correct value and reenter. 

INVALID The supplied HELP parameter is invalid. 

PARAMETER 

xxxx 

ACTION: Enter HELP for a list of valid parameters. 

Reenter the HELP command with a valid 
parameter. 

Value type for a variable or subscript 
does not match the value input. 


ACTION: Verify variable type and reenter in proper 

format. 

INTERNAL Internal error. 

ERROR - 

STACK 

UNDERFLOW 

ACTION: Submit PSR. 

INTERNAL Too many levels of record and array declarations 

ERROR - exist in the variable to allow CCDBG to 

SYMBOL TOO display it. 

COMPLEX 


INVALID 

VALUE 

SPECIFIED 

FOR 

VARIABLE 
OF TYPE x 


INVALID 

FIRST, 

LAST OR 
STEP VALUE 
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INVALID 

QUALIFIER 

FOR 

OVERLAY 

TRAPS 


INVALID 
TRAP TYPE 
xxxx 


LINE 

NUMBERS 

NOT 

AVAILABLE 


NO DEFAULT 
MODULE 


NO ENTRY 
POINT xxx 


NO FILE OR 

PROCEDURE 

xxxx 


NO LABEL 
xxxx 


ACTION: Display portions of the record. 

An overlay trap qualifier other than an overlay 
designation was specified in a SET TRAP, 

LIST TRAP, CLEAR TRAP, or SAVE TRAP 
command. 

ACTION: Correct and reenter. 

A SET_TRAP command has an invalid trap type 
parameter value. 

ACTION: Reenter with a valid trap type. 

An attempt was made to reference a line number 
in an explicitly named or default module 
other than a program 
compiled with the DEBUG option. 

ACTION: Check the home program. 

A command has been entered that requires a module 
specification, no module was specified, and no 
default module is established. 

ACTION: Define a default module or reenter command 

with module specified. 

A reference has been made to an entry point 
name xxxx which does nost exist; or if an overlay 
qualifier has been supplied, it is not in that 
overlay. 

ACTION: Check spelling or overlay qualifier; correct 

and reenter. 

The file or debugger SCL procedure named in a 
READ parameter does not exist. 

ACTION: Check spelling; check to see if the file is 

logically connected to the job. 

A GOTO command has referenced a label which 

does not exist in the current Debug command sequence. 

ACTION: Correct the Debug sequence accordingly. 
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NO MODULE A reference has been made to a module xxxx 
xxxx which does not exist; or if an overlay qualifier is 

supplied, the module is not in that overlay. 

Remember that module is a 1 - 7 character name. 

ACTION: Correct and reenter. 

NO An overlay reference has been made in a nonoverlay 

OVERLAYS environment. This error is detected at collect time 

if it occurs in a debugger SCL procedure, or if a 
specific overlay is referenced. 

ACTION: Confine Debug commands and address 

qualifiers to those acceptable in a 
nonoverlay environment. 

NO OVERLAY The specified overlay does not exist. DISPLAY_MAP 
(xxxx) indicates all existing overlays. 

ACTION: Reenter with the corrected overlay 

designation. 

NO An attempt was made to reference a CYBIL-CC 

VARIABLE variable xxxx. No such variable exists in the 

xxxx referenced or default module or the variable was not 

used. 

ACTION: Check spelling and the home program. 

NON - Field is not defined in current record. 

EXISTENT 
FIELD xxxx 

ACTION: Correct and reenter. 

NOT IN A COLLECT_END command has been entered when 

COLLECT not in collect mode. 

MODE - 

COLLECT_END 

IGNORED 

ACTION: None. 

OPTION An invalid option code was specified in the 

CODE MUST option list of a SET_OUTPUT or SET_AUXILIARY 
BE B, D, command. 

E, I, R, 

T, OR W 

ACTION: Reenter with all valid option codes. 
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POINTER A debug command has attempted to evaluate 

VARIABLE a pointer variable that has not been set. 

NOT 

INITIALIZED 

ACTION: None. 

PROC xxxx TRACEBACK cannot proceed because the 
NOT CALLED specified procedure has never been called. 

ACTION: Enter another command. 

Automatic variables are not available 
because the procedure is not active. 

ACTION: None. 

PROGRAM An attempt has been made with either GO or 

HAS EXECUTE to continue program execution from 

COMPLETED the point where program termination has been reached. 

ACTION: Reenter specifying some other execution 

addresses, or issue QUIT. 

RECURSIVE The debugger SCL procedure or file named in 

READ OF the current READ parameter is a nested 

xxxx procedure or the current sequence. 

ACTION: Redesign sequence logic to avoid this 

situation. 

RELATIVE A module offset is equal to or greater than its 

ADDRESS length. DISPLAY_MAP gives the program length. 

OUTSIDE 

BLOCK 

ACTION: Check for the missing octal suffix (8) on 

the offset value if octal was intended. 
Correct and reenter. 

RESPONSE In response to an error, warning, veto, or 
QUALIFIER interrupt of a Debug sequence, a response keyword 
MUST BE has been followed by text beginning with other 

LINE OR than LINE, SEQ or ; (semi-colon). 

SEQ 

ACTION: Enter any desired valid response. 

SPECIFIED The given value is not in the specified set. 

VALUE NOT 
IN SET 


PROC xxxx 
NOT IN 
STACK 
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STACK An invalid stack pointer has been found. 

POINTER 
OUTSIDE 
USER AREA 

ACTION: None. 

A field of a record was specified after 
an array field in a variable entry 
without specifing a subscript. 

ACTION: Correct and reenter. 

SUBSCRIPT A subscript value has been specified that is 

VALUE i outside the range for the array. 

OUT OF 
RANGE 

ACTION: Correct and reenter. 

SYMBOL Internal error. 

NUMBER i 
NOT FOUND 

ACTION: Submit PSR. 

SYMBOL Internal error. 

WITH 

RELOCATION 
TYPE i 
NOT 

ACCESSABLE 

ACTION: Submit PSR. 

SYNTAX Command with keywords added is too long 

ERROR - for buffer. 

COMMAND 
TOO LONG 

ACTION: Break command up if possible so fewer 

parameters are needed. 

SYNTAX A DISPLAY_MEMORY command has not been 

ERROR - entered. 

DISPLAY_ 

MEMORY 
MUST 
PRECEDE 
FORWARD OR 
BACKWARD 

ACTION: Enter a DISPLAY_MEMORY before doing FORWARD 

or BACKWARD. 


SUBSCRIPT 
REQUIRED 
AFTER 
ARRAY xxxx 
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SYNTAX The parameter specified in the message has 

ERROR - been given more that one value. 

DOUBLY 

DEFINED 

PARAMETER 

ACTION: Correct syntax and reenter. 

SYNTAX An incorrect parameter type was found. 

ERROR - The message tells what was expected and what 

EXPECTING was found for the specified parameter. 

ACTION: Correct syntax and reenter. 

SYNTAX Either the address parameters are not 

ERROR - allowed together (i.e., proc and location) 

IMPROPERLY or another parameter is needed with 
QUALIFIED them (i.e., module must be supplied 
ADDRESS when proc and overlay are). 

ACTION: Check syntax, correct and reenter. 

The syntax described by the message is illegal. 


ACTION: Correct syntax and reenter. 

SYNTAX An arithmetic operation has caused the integer 

ERROR - to become too large. 

INTEGER 

OVERFLOW 

ACTION: Check numeric parameters. If problem 

persists, submit PSR. 

SYNTAX The value entered is too large. 

ERROR - 
INTEGER 
TOO LARGE 

ACTION: Correct and reenter. 

SYNTAX The specified parameter must be entered for 

ERROR - this command. 

REQUIRED 

PARAMETER 

MISSING 

ACTION: Reenter command specifying the required 

parameter. 


SYNTAX 
ERROR - 
INVALID 
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SYNTAX String exceeds maximum allowable length. 

ERROR - 

STRING 

OVERFLOW 

ACTION: Correct and reenter. 

SYNTAX CCDBG internal tables are filled. 

ERROR - 

TABLE 

OVERFLOW 

ACTION: Submit PSR. 

SYNTAX Not enough of the specified item were input. 

ERROR - 
TOO FEW 

ACTION: Correct and reenter. 

SYNTAX Too many of the specified item were input. 

ERROR - 
TOO MANY 

ACTION: Correct and reenter. 

SYNTAX Parenthesis or brackets are not matched. 

ERROR - 

UNBALANCED 

ACTION: Correct and reenter. 
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SYNTAX The specified keyword is not valid for 

ERROR - this command. 

UNKNOWN 

KEYWORD 

ACTION: Check syntax, correct and reenter. 

SYNTAX Parameter value is not within 

ERROR - allowable range. 

VALUE OUT 
OF RANGE 

ACTION: Check syntax, correct and reenter. 

SYNTAX A value range was specified for a 

ERROR - parameter that cannot have a range. 

VALUE 
RANGE NOT 
ALLOWED 

ACTION: Check syntax, correct and reenter. 
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TOO MANY The number of breakpoints has reached the maxi- 
BREAKPOINTS mum allowed. 

ACTION: One or more existing breakpoints must be 

cleared before any new ones can be set. 

TOO MANY The number of debugger SCL procedures has 
PROCEDURES reached the maximum allowed. 

ACTION: One or more existing groups must be cleared 

before any new ones can be set. 

TOO MANY The number of nested debugger SCL procedures has 
NESTED reached the maximum allowed. A READ or PAUSE 

COMMAND command is not allowed until the current 

SEQUENCES procedure is terminated and the previous 
procedure is resumed. 

ACTION: Enter GO to resume the previous sequence 

immediately. 

TOO MANY The TRACEBACK output has reached its built-in 
TRACE feasibility limit. Program logic flow could 

LEVELS have errors. 

ACTION: Correct and reenter. 

TOO MANY The number of traps has reached the maximum 
TRAPS allowed. 

ACTION: Clear one or more existing traps before 

setting new ones. 

UNKNOWN The command text does not contain a syntactically 

COMMAND recognizable command name. If this error occurs 

in a debugger SCL procedure, it is detected at 
collect time. HELP CMDS list all valid 
command names. 

ACTION: Check spelling. Reenter a valid command. 

VARIABLE The referenced variable in an explicitly named or 
NAMES NOT default module must be in a CYBIL-CC program 
AVAILABLE compiled with the DEBUG option. 

ACTION: Check the home program. 
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xxxx IS 
NOT AN 
ARRAY 
VARIABLE 


A subscript is included in a variable 
declaration for a variable that is not 
type array. 

ACTION: Correct and reenter. 


xxxx IS 
NOT A 
POINTER 
VARIABLE 


A pointer symbol ( ) has been used in a 
variable declaration for a variable that 
is not type pointer. 

ACTION: Correct and reenter. 


xxxx IS A field name has been specified for a 

NOT A variable that cannot have fields. 

RECORD OR 
ARRAY OF 
RECORDS 

ACTION: Correct and reenter. 


5.2 WARNING MESSAGES 
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Warning messages issued by CCDBG are listed below. These 
messages have one of the following forms: 

*WARN - message text 
OK? 

*CMD - (command text) *WARN - message text 
OK? 

These messages indicate by their wording the action that is 
taken if the user responds with a positive acknowledgement (YES, 
ACCEPT, or OK). 

Warning messages can be suppressed by issuing a SET OUTPUT 
command that does not include the W parameter in its option list. 
The action indicated in the message automatically occurs. 
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Message 


ADAPTABLE STRING 
LENGTH WILL INCREASE 
FROM i TO i 

ADDRESS RANGE WILL 
BE TRUNCATED 


ALL WILL BE CLEARED 


BREAKPOINT WILL BE 
SET AT ENTRY POINT 


EXISTING AUXILIARY 
FILE WILL BE 
CLOSED 

EXISTING BREAKPOINT 
WILL BE REDEFINED 


EXISTING CHECKPOINT 
FILE WILL BE 
OVERWRITTEN 

PROCEDURE xxx WILL 
BE REDEFINED 


LINE STARTS IN 
PARCEL 3. BKPT SET 
IN NEXT WORD. 

LINE n NOT 
EXECUTABLE - LINE m 
WILL BE USED 


Significance 


This CHANGE_VARIABLE command will 
lengthen the adaptable string variable, 
and possibly overwrite other data. 

An address range for CHANGE, DISPLAY, 
or MOVE extends beyond the user field 
length or into DBUG, beyond the first 100 
(approximately) locations. 

A CLEAR_TRAP, CLEAR_BREAKPOINT, or 
CLEAR_PROCEDURE command has been issued 
with no parameters. 

This warning is issued only if the 
specified address is an entry point, but 
was not specified as such in a 
SET_BREAKPOINT command. 

A SET_AUXILIARY command has been issued 
which specifies a file name different 
from that of the existing auxiliary file. 

An attempt is being made to set a 
breakpoint where one already exists. A 
positive acknowledgement causes the new 
definition to override the old one. 

A CHECKPOINT command has been issued 
giving an existing file name. 


The name supplied in a SET_PROCEDURE 
command is that of a currently existing 
PROCEDURE. A positive acknowledgement 
causes the new definition to override the 
old one. 

One 15 bit instruction for this line 
of the program will be executed before 
breakpoint is honored. 

The specified line number is not 
executable or is nonexistent. A positive 
acknowledgement causes line m to be used 
instead. 

A CHECKPOINT command has been issued 
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FILE WILL BE 
RETURNED 


while a permanent suspend file exists 
without write or modify access. 


TRAP #n, type, 
qualifiers, WILL 
BE CLEARED 


A pending SET_TRAP command has a scope 
which overlays the scope of an existing 
trap of the same type. A positive 
acknowledgement CLEARS trap #n. 


5.2.1 INFORMATIVE MESSAGES 


Informative messages issued by CCDBG are listed below. These 
messages have the form: 

message text 

Informative messages indicate the following: changes in the 
status of CCDBG, changes in the status of commands that process a 
list, commands which confirm specific actions taken, when a list 
element cannot be processed, and when there is no action to be 
taken. 

After the informative message is issued, CCDBG does not pause 
for a response, except when the message announces the start or 
resumption of a CCDBG session. Any remaining elements in a list 
are processed after reporting a list element that cannot be 
processed. 
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Message 


CYBIL-CC INTERACTIVE 
DEBUG 


Significance 


After the program to be debugged has 
been loaded, this message is issued when 
CCDBG receives control. An initial set 
of traps and/or breakpoints should be 
established at this point before starting 
program execution. 


CYBIL-CC INTERACTIVE 
DEBUG RESTARTED 


A CCDBG session has been resumed from 
the point where it was checkpointed. The 
system command statement DEBUG 
(RESUME,filename) has been entered 
following the issue of a CHECKPOINT 
command. 


CYBIL MODULE 
NEXT, STACK POINTER 
ASSUMED IN REG B2 


DEBUG ABORTED 


Previous modules in a traceback have not 
been CYBIL-CC modules. Continued 
traceback is possible only if register B2 
still contains a valid stack pointer. 

This message is issued in response to 
QUIT ABORT; it appears in the dayfile as 
well. 


DEBUG TERMINATED 


END COLLECT 


This message is issued in response to 
QUIT or QUIT NORMAL; it appears in the 
dayfile as well. 

Sufficient collect_end commands have been 
encountered to reduce the collect level 
to zero, thus ending collect mode. 
Interactive command mode is resumed; 
entered commands are immediately 
executed. 


IN COLLECT MODE 
(,LEVEL n) 


This message occurs when the user 
receives CCDBG control in collect mode; 
this was not the case when the user last 
had control. Any subsequent commands 
entered will no longer be executed 
immediately, but will be checked for 
syntax and collected into a debugger SCL 
procedure for future execution. Level n 
is included in the message if a nested 
collect is in effect (n is greater than 
one). To end collect mode, n collect_end 
commands are required. 
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INTERRUPT IGNORED 


INTERRUPTED 


INTERPRET MODE 
TURNED OFF 


INTERPRET MODE 
TURNED ON 


CCDBG was already in interactive command 
mode when a terminal interrupt occurred. 
Since the purpose of a terminal interrupt 
is to place CCDBG in interactive mode, 
the interrupt is ignored. 

A terminal interrupt has occurred while a 
debugger SCL procedure or a command which 
takes a list as a parameter was 
executing. 

As a result of clearing one or more 
traps, no traps remain that require 
interpret mode to be on. Subsequent 
program execution will be by direct 
execution of the machine instructions. 

A SET_TRAP command has been issued with 
a trap type that requires interpret mode 
of program execution, and, currently, 
interpret mode is off. Subsequent 
program execution will be by interpreting 
all machine instructions. 


NO BREAKPOINT xxxx 


NO BREAKPOINT #n 


A request has been made to DISPLAY, 

CLEAR, or SAVE a breakpoint at location 
xxxx. No such breakpoint exists. Any 
remaining list elements are processed. 

A request has been made to DISPLAY, 

CLEAR, or SAVE a breakpoint #n which does 
not exist. Any remaining list elements 
are processed. 


NO BREAKPOINTS 


There are no breakpoints to DISPLAY, 
CLEAR, or SAVE. 
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Message 


NO PROCEDURE xxxx 


NO PROCEDURES 


Significance 


A request has been made to DISPLAY, 

CLEAR, or SAVE a debugger SCL procedure 
xxxx which does not exist. Any remaining 
list elements are processed. 

There are no debugger SCL procedures to 
DISPLAY, CLEAR, or SAVE. 


NO xxxx TRAP yyyy 


NO TRAP #n 


NO TRAPS 


A request has been made to DISPLAY, 

CLEAR, or SAVE a user-defined trap of 
type xxxx with scope yyyy. No such trap 
exists. Any remaining list elements are 
processed. 

A request has been made to DISPLAY, 

CLEAR, or SAVE a user-defined trap #n 
which does not exist. Any remaining list 
elements are processed. 

There are no user-defined traps to 
DISPLAY, CLEAR, or SAVE. Note that the 
three default traps: END, ABORT, and 
INTERRUPT are never displayed, cleared or 
saved. 


PAUSE IGNORED FROM 
TERMINAL 


This mesage results from entering 
PAUSE while in interactive (non-collect) 
mode. 


TIME LIMIT 


A time limit interrupt has occurred while 
either the program or a CCDBG sequence 
was executing. A small amount of time is 
left, sufficient to do a SAVE_ALL and 
QUIT. To continue the session, enter 
CHECKPOINT, followed by a QUIT and 
DEBUG(RESUME). 


TRAP NUMBER IGNORED 
IN THIS CONTEXT 


A trap number has been specified as a 
list element in DISPLAY_TRAP, CLEAR_TRAP, 
or SAVE_TRAP command of a form for which 
trap numbers are not allowed. Any 
remaining list elements are processed. 
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USER PROGRAM A program interrupt was detected while 

INTERRUPT PENDING execution of a CYBIL-CC statement 

compiled with the DEBUG parameter was in 
progress. Unless a second interrupt is 
issued, the interrupt is delayed until 
the execution of the current statement is 
completed. However, in the interim, a 
breakpoint or trap with no body or a 
PAUSE statement has been encountered. 

This message cautions that control is to 
be given to the user by some means other 
than the result of the terminal input. 

The terminal interrupt is acknowledged. 
Control is regained by entering GO or 
EXECUTE, causing the CYBIL-CC statement 
to complete its execution. 


USER RECOVER ROUTINE 
COMPLETED, x 
REQUESTED 


CCDBG issues this message after the user 
program has completed its recover 
routine by making an ABORT or ENDRUN 
request. 


VARIABLE NAMES NOT 
AVAILABLE FOR xxx 

xxx TREATED AS ; 


Either program xxx is not a CYBIL-CC 
program, or it was not compiled with the 
DEBUG option explicitly specified. 

A collect was found following a command 
other than SET_TRAP, SET_BREAKPOINT, or 
SET_PROCEDURE; or a COLLECT_END was found 
after a statement while not in collect 
mode. 


+ 
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backward | bw numlocs=<integer> 

[format=oct | dec | adr | hex] 

change_defaults | cd [module=<name>] 

[proc=<name> [.<name>]...] 

[overlay=(<integer>,<integer>) ] 

change_memory | cm <address_expr>[module=<name>] 

[offset=<integer>] value=<expr> 
[numlocs=<integer>] [indirect] 

change_registers cr a | b | x=<integer> 

value=<expr> [indirect] 

change_variable | cv var=<name> value=<expr> 

[module=<name>] [proc=<name> 

[.<name>]...] 

checkpoint | ck file=<name> 

clear_auxiliary | caux 

clear_breakpoint | cb [scope_expr] 

[b=<integer>[<..><integer>]| 
(<integer>[<..><integer>] 
[<sepxinteger> [< . . ><integer>] ] . . . ) ] 
[offset=<integer>] 

[overlay=(<integer>,<integer>)] 

[modu1e=<name>] 

clear_interpret | ci 

clear_procedure | cp [procedure=<name> | 

(<name> [<sepxname>] . . . ) ] 

[type=<trap_type>][scope_expr] 
[t=<integer>[<..><integer>]| 
(<integer> [< . . xinteger>] 
[<sepxinteger> [< . . xinteger>] ] . . . ) ] 
[overlay=(<integer>,<integer>)] 
[module=<name>] [proc=<name> 

[.<name>]...] 

clear_veto | eve 


clear_trap | ct 
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display_breakpoint | db [address_expr] 

[b=<integer>[<..><integer>] | 
(<integer> [<..><integer>] 
[<sepxinteger> [< . . ><integer>] ] . . . ) ] 
[offset=<integer>] 

[overlay=(<integer>,<integer>)] 
[module=<name>] 

display_default | dd 

display_map | dmap [module=<name>] 

[overlay=(<integer>,<integer>) ] 

display_memory | dm <address_expr> 

[format=oct | dec | adr | hex] 
[numlocs=<integer>] 

[offset=<integer>] [module=<name>] 
[indirect] 

display_procedure | dp [procedure=<name> | 

(<name> [<sepxname>] . . .) ] 

display_registers dr [p | f1 | [a | b | x=[<integer>]]] 

[format=oct | dec | adr | hex] 
[indirect] 

display_status | ds 

display_trap | dt [type=<trap_type>] [scope_expr] 

[t=<integer>[<..><integer>]| 
(<integer> [< . . xinteger>] 
[<sepxinteger> [< . . xinteger>] ] . . . ) ] 
[overlay=<integer>,<integer>) ] 
[module=<name>] [proc=<name> 

[.<name>]...] 

display_variable | dv [var=<name>] 

[format=oct | dec | hex] 
[module=<name>] [proc=<name> 

[.<name>]...] 

execute | ex [address_expr] [offset=<integer>] 

forward | fw numlocs=<integer> 

[format=oct | dec | adr | hex] 

go [address_expr] [offset=<integer>] 
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help | h [<subject> | <command_name>] 

label | la name=<name> 

message | me [text='[<ascii>]...'] 

move | m source_expr destination_expr 

[numlocs=<integer>] 

pause | pa [text='[<ascii>]...'] 

quit [normal | abort] 

read | r file | procedure = <name> 

save_all | savea file=<name> 

save_breakpoint | saveb file=<name>[scope_expr] 

[b=<integer>[<..><integer>]| 
(<integer>[<..><integer>] 
[<sepxinteger> [< . . ><integer>] ] . . . ) ] 
[offset=<integer>] 

[overlay=(<integer>,<integer>)] 
[module=<name>] 

save_procedure | savep file=<name> 

[procedure=<name> | 

(<name> [<sepxname>] . . .) ] 

file=<name> [type=<trap_type>] 
[scope_expr] 

[t=<integer> [< . . xinteger>] 
(<integer>[<..><integer>] 
[<sepxinteger> [< . . xinteger>] ] . . . ) ] 
[overlay=(<integer>,<integer>)] 
[module=<name>] [proc=<name> 

[.<name>]...] 

set_auxiliary | saux file=<name> lo=<options> 

set_breakpoint | sb [address_expr] 

[module=<name>][overlay=(<integer> 
,<integer>)] [offset=<integer>] 

[first=<integer>] [last=<integer>] 

[step=<integer>] [<collectxeol | ;> 
[<command_statementxeol | ; >] ... 
ccollect end>] 


save_trap | savet 
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set_output | so 
set_procedure | sp 

set_trap | st 


set_veto | sve 
skipif | s 
traceback | tb 


lo=<options> 

procedure=<name> [<collectxeol | ;> 
[<command_statementxeol | ; >] . . . 
<collect_end>] 

type=<trap_type> [scope_expr] 
[overlay=(<integer>,<integer>) ] 
[module=<name>] [proc=<name> 
[.<name>] . . .] [ccollectxeol | ;> 
[<command_statementxeol | ; >] . . . 
ccollect end>] 


<value_lxrelationxvalue_2 > 
[entrypoint=<name>] 


60460320 01 





1 

CDC - SOFTWARE ENGINEERING SERVICES 

12/13/83 

ERS for CYBIL-CC Interactive Debugger REV: 1 

Table of Contents 

1.0 SCOPE. 1-1 

1.1 APPLICABLE DOCUMENTS . 1-1 

2.0 INTRODUCTION. 2-1 

2.1 OVERVIEW. 2-1 

2.2 TERMINOLOGY. 2-1 

2.3 METALANGUAGE. 2-3 

2.4 BASIC CONCEPTS. 2-4 

2.4.1 INTEGER. 2-4 

2.4.2 NAME. 2-4 

2.4.3 ADDRESS. 2-4 

2.4.4 CCDBG VARIABLES. 2-5 

2.4.5 EXPRESSION (EXPR) . 2-6 

2.4.6 SEPARATOR. 2-6 

2.4.7 COMMENTS. 2-6 

2.4.8 COMMAND. 2-6 

2.4.9 PARAMETER LISTS. 2-6 

2.4.10 VALUE LISTS . 2-7 

2.4.11 CONTINUATION . 2-7 

3.0 GENERAL DESCRIPTION OF CCDBG USE. 3-1 

3.1 PROGRAM EXECUTION CONTROL . 3-2 

3.2 CYBIL-CC SOURCE SYMBOL REFERENCE CAPABILITY . 3-2 

3.3 MACHINE LEVEL DEBUGGING FEATURES . 3-2 

3.4 OVERLAY ENVIRONMENT . 3-2 

3.5 DEBUGGER SCL PROCEDURE. 3-3 

3.6 CONDITIONAL COMMAND EXECUTION CAPABILITY . 3-3 

3.7 VETO MODE. 3-3 

3.8 DEFINITION FILE CAPABILITY. 3-3 

3.9 CHECKPOINT/RESTART CAPABILITY . 3-3 

3.10 WARNING CAPABILITY . 3-3 

3.11 CCDBG VARIABLES. 3-4 

3.12 INFORMATION OUTPUT . 3-4 

3.13 HELP COMMAND. 3-4 

4.0 CCDBG COMMANDS. 4-1 

4.1 BREAKPOINTS AND TRAPS. 4-1 

4.1.1 SET_BREAKPOINT | SB. 4-1 

4.1.2 SET_TRAP | ST. 4-3 

4.1.3 DIS PLAY_BRE AKPOI NT | DB. 4-6 

4.1.4 DISPLAY_TRAP | DT. 4-7 

4.1.5 S AVE_BRE AKPO I NT | SAVEB. 4-9 

4.1.6 SAVE_TRAP | SAVET. 4-10 

4.1.7 CLEAR_BREAKPOINT | CB. 4-12 

4.1.8 CLEAR_TRAP | CT. 4-13 

4.1.9 SET_INTERPRET | SI. 4-15 

4.1.10 CLEAR_INTERPRET | Cl. 4-15 

4.2 DISPLAYING AND CHANGING PROGRAM VARIABLES . 4-15 

4.2.1 DIS P L A Y_VAR IAB L E | DV. 4-15 

4.2.2 CHANGE_VARIABLE | CV. 4-17 

60460320 01 


















































CDC 


SOFTWARE ENGINEERING SERVICES 


2 


12/13/83 

ERS for CYBIL-CC Interactive Debugger REV: 1 

4.3 DISPLAYING AND CHANGING MEMORY AND REGISTERS .... 4-18 

4.3.1 DISPLAY_MEMORY | DM. 4-18 

4.3.2 FORWARD | FW. 4-19 

4.3.3 BACKWARD | BW. 4-20 

4.3.4 CHANGE_MEMORY | CM. 4-20 

4.3.5 DISPLAY_REGISTERS | DR. 4-21 

4.3.6 CHANGE_REGISTERS | CR. 4-22 

4.4 DEBUGGER SCL PROCEDURES. 4-23 

4.4.1 SET_PROCEDURE SP. 4-23 

4.4.2 DISPLAY_PROCEDURE DP. 4-23 

4.4.3 SAVE_PROCEDURE | SAVEP. 4-24 

4.4.4 CLEAR_PROCEDURE CP. 4-24 

4.5 DEBUGGER SCL PROCEDURE COMMANDS . 4-24 

4.5.1 PAUSE | PA. 4-25 

4.5.2 MESSAGE | ME. 4-25 

4.5.3 GO. 4-25 

4.5.4 SKIPIF | S. 4-26 

4.5.5 LABEL | LA. 4-27 

4.5.6 GOTO. 4-27 

4.5.7 READ R. 4-28 

4.6 ADDITIONAL INTERACTIVE MODE COMMANDS . 4-28 

4.6.1 EXECUTE | EX. 4-28 

4.6.2 TRACEBACK | TB. 4-29 

4.6.3 MOVE M. 4-29 

4.6.4 HELP H. 4-31 

4.6.5 SAVE_ALL | SAVEA. 4-31 

4.6.6 CHECKPOINT | CK. 4-31 

4.6.7 QUIT. 4-32 

4.7 CCDBG ENVIRONMENT COMMANDS . 4-32 

4.7.1 SET_VETO | SVE. 4-32 

4.7.2 CLEAR_VETO CVE. 4-32 

4.7.3 SET_OUTPUT SO. 4-32 

4.7.4 S E T_AUX ILI ARY | SAUX. 4-33 

4.7.5 C L E AR_AUX ILI ARY | CAUX. 4-33 

4.7.6 DISPLAY_MAP | DMAP. 4-33 

4.7.7 DISPLAY_DEFAULTS | DD. 4-34 

4.7.8 DISPLAYJ3TATUS | DS. 4-34 

4.7.9 CHANGE_DEFAULTS | CD. 4-35 

5.0 MESSAGES. 5-1 

5.1 DIAGNOSTIC MESSAGES . 5-1 

5.2 WARNING MESSAGES . 5-11 

5.2.1 INFORMATIVE MESSAGES . 5-13 

6.0 ALPHABETICAL COMMAND SUMMARY . 6-1 


60460320 01 













































